home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir38 / grabb397.zip / DOCFILES.SFX / GREDIT.DOC < prev    next >
Text File  |  1994-05-14  |  19KB  |  486 lines

  1.  
  2.  
  3.  
  4.                                      GREDIT (tm)
  5.                                 Shareware Release 4.4B
  6.  
  7.                             -----------------------------
  8.  
  9.                          A display screen editor for use with
  10.                        the GRABBER (tm) screen capture program
  11.  
  12.  
  13.  
  14.                                     DOCUMENTATION
  15.                                     May 14, 1994
  16.  
  17.  
  18.  
  19.                                 Copyright 1987-1994 by
  20.                                    Gerald A. Monroe
  21.                                  All rights reserved.
  22.  
  23.  
  24.  
  25.                  +-------------------------------------------------+
  26.                  |  Although they are shareware,  GREDIT and this  |
  27.                  |  documentation file are copyrighted.  They are  |
  28.                  |  not in the  public  domain  and they are  not  |
  29.                  |  "freeware."   Please  consult  page 6  of the  |
  30.                  |  REGISTER.DOC  file  for  important  copyright  |
  31.                  |  information and license provisions.            |
  32.                  +-------------------------------------------------+
  33.  
  34.                Thank you  for your interest in  the GRABBER(tm) screen
  35.                capture system!
  36.  
  37.                The GRABBER  package is being marketed  in this special
  38.                form as shareware.  This means you have the opportunity
  39.                to  use and evaluate it  for 30 days  before you decide
  40.                whether  to buy.   If you continue  to use GRABBER.EXE,
  41.                any of its  "offspring" programs, or  any of the  other
  42.                programs in  the  GRABBER package  beyond  such  30-day
  43.                period, then you are required to send your registration
  44.                fee to  the publisher according to  the instructions in
  45.                the  REGISTER.DOC file.   When  you register,  you will
  46.                receive a copy of the  latest release of the registered
  47.                GRABBER package that you  order.  You may  not continue
  48.                using GRABBER  beyond such 30-day period without regis-
  49.                tering.   For registration  instructions and a complete
  50.                statement of your license  to use this software, please
  51.                consult the REGISTER.DOC file.
  52.  
  53.                                 Gerald A. Monroe
  54.                                 P.O. Box 770906
  55.                                 Cleveland, Ohio 44107, U.S.A.
  56.                                 CompuServe Mail:  72321,1257
  57.                                 Fax:  (216) 521-6060
  58.  
  59.  
  60.           GREDIT                    Documentation               Page 2 of 9
  61.  
  62.  
  63.  
  64.                                   Table of Contents
  65.  
  66.                    Overview of GREDIT . . . . . . . . . . . . . . 3
  67.  
  68.                    Hardware & software requirements . . . . . . . 3
  69.  
  70.                    Starting GREDIT  . . . . . . . . . . . . . . . 3
  71.  
  72.                    Editing the GRABBER offspring file . . . . . . 4
  73.  
  74.                    Cursor movement keys . . . . . . . . . . . . . 4
  75.  
  76.                    Help screen, Alt-H . . . . . . . . . . . . . . 5
  77.  
  78.                    Quit GREDIT, Alt-Q . . . . . . . . . . . . . . 5
  79.  
  80.                    Save image to .EXE file, Alt-S . . . . . . . . 5
  81.  
  82.                    Save image to ANSI file, Alt-A . . . . . . . . 5
  83.  
  84.                    Set colors, Alt-F  . . . . . . . . . . . . . . 5
  85.  
  86.                    Toggle blink, Alt-L  . . . . . . . . . . . . . 5
  87.  
  88.                    Border color, Alt-B  . . . . . . . . . . . . . 6
  89.  
  90.                    Clear screen, Alt-K  . . . . . . . . . . . . . 6
  91.  
  92.                    Erase line, Alt-E  . . . . . . . . . . . . . . 6
  93.  
  94.                    Wipe screen, Alt-W . . . . . . . . . . . . . . 6
  95.  
  96.                    Toggle ruler, Alt-R  . . . . . . . . . . . . . 6
  97.  
  98.                    Set tabs, Alt-T  . . . . . . . . . . . . . . . 6
  99.  
  100.                    Import text file, Alt-I  . . . . . . . . . . . 7
  101.  
  102.                    Load new image, Alt-N  . . . . . . . . . . . . 7
  103.  
  104.                    Copy to clipboard, Alt-C . . . . . . . . . . . 7
  105.  
  106.                    Cut to clipboard, Alt-X  . . . . . . . . . . . 7
  107.  
  108.                    Paste from clipboard, Alt-P  . . . . . . . . . 8
  109.  
  110.                    Line-drawing help, Alt-D . . . . . . . . . . . 8
  111.  
  112.                    Graphics character help, Alt-G . . . . . . . . 8
  113.  
  114.                    Query colors at cursor, Alt-Y  . . . . . . . . 8
  115.  
  116.                    Turning off GREDIT's beep sounds . . . . . . . 9
  117.  
  118.           GREDIT                    Documentation               Page 3 of 9
  119.  
  120.  
  121.  
  122.           OVERVIEW OF GREDIT
  123.           -------------------
  124.  
  125.           GREDIT(tm) is a utility you can use to modify the screen images
  126.           which are generated by the GRABBER screen capture program. 
  127.           Throughout this document, these screen image files are referred
  128.           to as GRABBER "offspring."  If you are not familiar with GRABBER
  129.           and how it works, please read the program manual GRABBER.DOC
  130.           before attempting to use GREDIT.
  131.  
  132.           Only text images captured with GRABBER may be edited.  GREDIT
  133.           does not support GRABBER's graphic images.
  134.  
  135.  
  136.  
  137.           REQUIREMENTS
  138.           -------------
  139.  
  140.           GREDIT has the same hardware and software requirements as GRAB-
  141.           BER.  These are:
  142.  
  143.                a)   an IBM-PC, XT, AT, PS/2 or 100% IBM-compatible personal
  144.                     computer;
  145.  
  146.                b)   PC-DOS or MS-DOS, Version 3.0 or later; c) at least one
  147.                     diskette drive; and c) at least 256Kb free memory.
  148.  
  149.           You can use GREDIT with either a color or monochrome display.
  150.  
  151.  
  152.  
  153.           STARTING GREDIT
  154.           ----------------
  155.  
  156.           To start the program, simply type GREDIT at the DOS prompt,
  157.           optionally followed by the name of the GRABBER offspring file you
  158.           wish to edit, then press <RETURN>.  The correct syntax is:
  159.  
  160.                                   GREDIT [filename]
  161.  
  162.           If you omit the filename, the program will ask you to supply one.
  163.  
  164.           GREDIT assumes that the file you wish to edit has the extension
  165.           ".EXE" in its name.  Therefore, you can omit the extension when
  166.           specifying the file to be edited.  For instance, entering "GREDIT
  167.           SCREEN00" is the same as entering "GREDIT SCREEN00.EXE".
  168.  
  169.           GREDIT                    Documentation               Page 4 of 9
  170.  
  171.  
  172.  
  173.           EDITING THE OFFSPRING FILE
  174.           ---------------------------
  175.  
  176.           You are now inside GREDIT, with the cursor at the upper left-hand
  177.           corner of the screen.  You may use your keyboard to edit the
  178.           image inside the GRABBER offspring file, including its text
  179.           content, layout and color scheme.  At your disposal are all of
  180.           the alphanumeric and cursor-movement keys, the function keys <F1>
  181.           through <F10>, plus 17 special Alt-key functions which are
  182.           described below.
  183.  
  184.  
  185.  
  186.           CURSOR MOVEMENT
  187.           ----------------
  188.  
  189.           GREDIT supports the following keys on your PC keyboard to help
  190.           you move around inside your GRABBER offspring image.  Except for
  191.           the backspace key ( <X] ), none of these keys alters the image on
  192.           the screen; they merely move the editing cursor to the desired
  193.           location.
  194.  
  195.  
  196.           [UP ARROW]  . . . . . . cursor up one line
  197.           [DOWN ARROW]  . . . . . cursor down one line
  198.           [LEFT ARROW]  . . . . . cursor one space to the left
  199.           [RIGHT ARROW] . . . . . cursor one space to the right
  200.           [HOME]  . . . . . . . . cursor to upper left corner of display
  201.           [PAGE UP] . . . . . . . cursor to upper right corner of display
  202.           [END] . . . . . . . . . cursor to lower left corner of display
  203.           [PAGE DOWN] . . . . . . cursor to lower right corner of display
  204.           [RETURN]  . . . . . . . cursor to left edge, next line down
  205.           [TAB] . . . . . . . . . cursor right to next tab stop
  206.           [SHIFT-TAB] . . . . . . cursor left to previous tab stop
  207.           [BACKSPACE] . . . . . . cursor one space left, erase char. there
  208.  
  209.  
  210.           The [INSERT] key deserves a special mention.  This key does not
  211.           allow you to insert characters into a line as you would expect
  212.           using a word processor.  Rather, holding down the [INSERT] key
  213.           while pressing another alphanumeric or function key 1-10 causes
  214.           the editing cursor to advance backward from right to left.  This
  215.           can be helpful when drawing boxes with the <F1-F10> keys.
  216.  
  217.           GREDIT                    Documentation               Page 5 of 9
  218.  
  219.  
  220.  
  221.           GREDIT ALT-KEY FUNCTIONS
  222.           -------------------------
  223.  
  224.  
  225.             KEY                          FUNCTION
  226.           -------   ------------------------------------------------------
  227.  
  228.           Alt-H     Help
  229.  
  230.                     This function pops up a list of all of GREDIT's special
  231.                     Alt-key functions and a brief description of each. 
  232.                     Press any key to resume editing.
  233.  
  234.  
  235.           Alt-Q     Quit
  236.  
  237.                     This function exits GREDIT, and gives you the option of
  238.                     saving your changes to disk before leaving.
  239.  
  240.  
  241.           Alt-S     Save
  242.  
  243.                     This function saves your changes to disk without exit-
  244.                     ing the program.
  245.  
  246.  
  247.           Alt-A     Save to ANSI file
  248.  
  249.                     This function saves the current image to an ANSI-en-
  250.                     coded file.  ANSI files are text files which contain
  251.                     special control codes that preserve all of the colors
  252.                     in the image.  The Alt-A function performs the same
  253.                     task as the separate GR2ANSI(tm) program, a command-
  254.                     line utility which is also included in the GRABBER
  255.                     package.
  256.  
  257.  
  258.           Alt-F     Colors
  259.  
  260.                     This function lets you change the global color attrib-
  261.                     ute.  To adjust the foreground color, press the up and
  262.                     down arrow keys.  To adjust the background color, press
  263.                     the left and right arrow keys.  To resume editing,
  264.                     press <Esc> or <Return>.  Users with monochrome systems
  265.                     should also read about the Alt-Y function below.
  266.  
  267.  
  268.           Alt-L     Blink
  269.  
  270.                     This function toggles the "blink" attribute on and off
  271.                     for characters typed at the keyboard.
  272.  
  273.           GREDIT                    Documentation               Page 6 of 9
  274.  
  275.  
  276.  
  277.             KEY                          FUNCTION
  278.           -------   ------------------------------------------------------
  279.  
  280.           Alt-B     Border color
  281.  
  282.                     This function lets you adjust the color of the screen
  283.                     border on color systems.  Border color is not available
  284.                     on monochrome systems.
  285.  
  286.  
  287.           Alt-K     Clear screen
  288.  
  289.                     This function erases the entire display, and fills it
  290.                     with the last color you specified using the Alt-F
  291.                     function.
  292.  
  293.  
  294.           Alt-E     Erase line
  295.  
  296.                     This function erases the line on which the cursor is
  297.                     currently located.  To avoid accidental erasures, Alt-E
  298.                     must be pressed twice.  The erased line will be filled
  299.                     with the last color you specified using the Alt-F
  300.                     function.
  301.  
  302.  
  303.           Alt-W     Wipe
  304.  
  305.                     This function lets you change either the foreground or
  306.                     the background color of ALL characters on the screen at
  307.                     once.  After pressing Alt-W, press <F> to wipe the
  308.                     foreground, or <B> to wipe the background, or any other
  309.                     key to cancel.  The foreground or background will be
  310.                     wiped to the last color you specified using the Alt-F
  311.                     function.
  312.  
  313.  
  314.           Alt-R     Ruler
  315.  
  316.                     This function toggles on and off the ruler display at
  317.                     the top of the screen.  The ruler shows all of the
  318.                     currently defined tab stops.  While the ruler is being
  319.                     displayed, you cannot make changes to the top line of
  320.                     the image.
  321.  
  322.  
  323.           Alt-T     Tabs
  324.  
  325.                     This function lets you adjust the tab value.  The
  326.                     minimum tab value is always 2.  The maximum value
  327.                     equals the number of character spaces per line, minus
  328.                     one.
  329.  
  330.           GREDIT                    Documentation               Page 7 of 9
  331.  
  332.  
  333.  
  334.             KEY                          FUNCTION
  335.           -------   ------------------------------------------------------
  336.  
  337.           Alt-I     Import
  338.  
  339.                     This function allows you to import plain ASCII text
  340.                     files into your image.  Imported files are overlaid
  341.                     onto whatever image already exists on the screen, using
  342.                     the foreground and background colors you specified with
  343.                     the most recent Alt-F function.  GREDIT reads in only
  344.                     as much of the text file as will fit on the screen,
  345.                     starting from the top of the file.
  346.  
  347.  
  348.           Alt-N     New offspring
  349.  
  350.                     This function lets you load and edit a new GRABBER
  351.                     offspring image.  Alt-N does not remind you to save the
  352.                     current image before loading another, so you may want
  353.                     to invoke Alt-S first.
  354.  
  355.  
  356.           Alt-C     Copy to clipboard
  357.  
  358.                     This function allows you to specify a rectangular area
  359.                     of the image to copy to GREDIT's off-screen "clipboard"
  360.                     storage area.  First, move the cursor to one of the
  361.                     four corners of the area to be copied, and press Alt-C. 
  362.                     Then, use the arrow keys to move the cursor to the
  363.                     *opposite* corner of the area to be saved, and press
  364.                     <Return>.  To confirm the area selected, press <Return>
  365.                     again, or press <Esc> to cancel.  Please note that
  366.                     GREDIT's clipboard can fit only one item at a time;
  367.                     when you copy something to the clipboard, you erase the
  368.                     clipboard's previous contents.
  369.  
  370.  
  371.           Alt-X     Cut to clipboard
  372.  
  373.                     This function works exactly like the Alt-C function de-
  374.                     scribed above, with one difference.  Whatever portion
  375.                     of the image you select will also be erased from the
  376.                     screen after it is moved to the clipboard.
  377.  
  378.           GREDIT                    Documentation               Page 8 of 9
  379.  
  380.  
  381.  
  382.             KEY                          FUNCTION
  383.           -------   ------------------------------------------------------
  384.  
  385.           Alt-P     Paste from clipboard
  386.  
  387.                     This function can be used to paste the contents of the
  388.                     clipboard back to the screen.  First, move the cursor
  389.                     to the upper-left corner of the area you wish to fill
  390.                     from the clipboard, and press Alt-P.  GREDIT will show
  391.                     you the outlines of the area saved on the clipboard. 
  392.                     To confirm the Paste operation, press <Return>, or
  393.                     press <Esc> to cancel.
  394.  
  395.  
  396.           Alt-D     Line-drawing help
  397.  
  398.                     This function pops up a list of line- and box-drawing
  399.                     characters, and the function keys (F1 through F10)
  400.                     which are associated with them.  To access these char-
  401.                     acters in GREDIT, press the function  key indicated in
  402.                     the list, either alone or together with the <Shift>,
  403.                     <Ctrl> or <Alt> keys.  Press any key to exit the list
  404.                     and resume editing.
  405.  
  406.  
  407.           Alt-G     Graphics character help
  408.  
  409.                     This function pops up a table showing all the special
  410.                     graphics characters in the IBM-PC character set.  The
  411.                     numbers at the left and top of the grid are added
  412.                     together to determine the ASCII code of any character
  413.                     in the table. To access these characters in GREDIT,
  414.                     first hold down the <Alt> key, then type the charac-
  415.                     ter's ASCII code on your keyboard's numeric keypad, and
  416.                     then release the <Alt> key.
  417.  
  418.  
  419.           Alt-Y     Query attribute at cursor
  420.  
  421.                     This function is available on monochrome systems only. 
  422.                     It allows you to determine how a certain character will
  423.                     appear if the offspring screen is later shown on a
  424.                     color display.  Move the cursor to the character you
  425.                     want to check, and press Alt-Y.  The top line of the
  426.                     display will tell you the "foreground-on-background"
  427.                     color scheme for this character if it were shown on a
  428.                     color system.
  429.  
  430.           GREDIT                    Documentation               Page 9 of 9
  431.  
  432.  
  433.  
  434.           ELIMINATING GREDIT's BEEP SOUNDS
  435.           ---------------------------------
  436.  
  437.           To eliminate the beep sounds which GREDIT normally makes when you
  438.           invoke any of its special Alt-key functions, include the /Q
  439.           command-line switch when you start the program at the DOS prompt. 
  440.           For example:
  441.  
  442.                                    GREDIT /Q
  443.                             or,
  444.                                    GREDIT screenxx /Q
  445.  
  446.           If you omit the /Q switch from the command line and later decide
  447.           to turn off the beep sounds, you must exit the program (don't
  448.           forget to save your work) and restart the program using the /Q
  449.           switch on the command line.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.                            * * *  End of GREDIT.DOC  * * *
  486.